Crate quote_use

Description

Macro to simplify using Types in the quote! macro.

Usage

The quote_use! macro can be used just like quote!, but with the added functionality of adding use statements at the top:

quote_use! {
    # use std::fs::read;

    read("src/main.rs")
}

This will expand to the equivalent statement using quote!:

quote! {
    ::std::fs::read::read("src/main.rs")
}

Prelude

This also allows using contents of the rust prelude directly:

quote_use! {
    Some("src/main.rs")
}

Overriding prelude

When you want to use your own type instead of the prelude type this can be achieved by simply importing it like so

quote_use! {
    # use anyhow::Result;

    Result
}

Different preludes

By default quote_use! uses the core prelude, std prelude and 2021 edition prelude. Preferring core where available.

All preludes can be disabled by adding # use no_prelude; at the top of the macro input. The std prelude can be disabled with # use no_std_prelude;.

Other quote macros

There are also variants for other quote macros from syn and quote:

• quote_use! and quote_spanned_use! as replacement for quote! and quote_spanned! respectively
• parse_quote_use! and parse_quote_spanned_use! for parse_quote! and parse_quote_spanned!

Macros

• format_ident
  Formatting macro for constructing Idents.
• parse_quote_spanned_use
• parse_quote_spanned_use_no_prelude
• parse_quote_use
• parse_quote_use_no_prelude
• quote_spanned_use
• quote_spanned_use_no_prelude
• quote_use
• quote_use_no_prelude

Traits

• IdentFragment
  Specialized formatting trait used by format_ident!.
• ToTokens
  Types that can be interpolated inside a quote! invocation.
• TokenStreamExt
  TokenStream extension trait with methods for appending tokens.